Short:    Cybergfx only picture viewer V1.14
Author:   al.renard@infoboard.be(Alain Renard)
Uploader: al.renard@infoboard.be(Alain Renard)
Version:  1.14
Type:     gfx/show

New in version 1.14
===================
- Show can now be started from WB.
- Preferences grouped into a window.
- While browsing the memorized pictures in the 'Goto memorized' window, you now see
  the images directly.

New in version 1.13
===================
- Added the LIST/K argument in the command line. See Below.

New in version 1.12
===================
- The grayscale images are now loaded/saved as grayscale in TIFF format
- Added Gamma for PNG loading
- More prefs are saved now

New in version 1.11
===================
- Load and save TIFF images.
- Now you can resize the picture freely.
- New menu item: Gamma correction.
- ATTENTION : ixemul.library is now needed!
- ATTENTION : new prefs file format...sorry! :(

What is it?
===========
Show is a picture viewer for CyberGraphics systems.
It can decode the next picture formats:
- JPEG,PNG,GIF,TARGA,BMP,PPM,TIFF
and can save in
- JPEG,PNG,TIFF and RAW
It open on a CyberGraphics screen (16/24bits) only.

Invocation from a shell:
========================
	Show    PATTERN,MODEID=ID/K/N,LOOP=LP/S,NOERROR=NE/S,GETMODEID=GM/S,
			PROGRESS=PG/S,CRYPT=CR/S,PRESERVE=PR/S,OVERWARN=OW/S,CLICK=CL/S,
			LIST=LI/K,JPGQUAL=JQ/K/N,JPGGRAY=JG/S,JPGSIZE=JS/K/N

PATTERN:
	- Just a filename, eg : RAM:T/mypic.jpg
	- A pattern, eg: RAM:T/#?30#?.tiff
	- A directory, eg: RAM:T/
	  Equivalent to RAM:T/#?
	  (You have to put the '/' at the end to indicate a directory!)

MODEID=ID/K/N:
	The screen mode (in decimal)

LOOP=LP/S:
	If you want endless loop in viewing.

NOERROR=NE/S:
	If you do not want the errors being reported.

GETMODEID=GM/S:
	Force the mode requester to appear before the program starts.

PROGRESS=PG/S:
	Open the progress window when loading a picture.

CRYPT=CR/S:
	Save files crypted.

PRESERVE=PR/S:
	Preserve files dates.

OVERWARN=OW/S:
	Open a requester to ask if you want to overwrite a file.

CLICK=CL/S:
	Click with the mouse in the main window loads the next picture.

LIST=LI/K:
	Take precedence over the FILES argument.
	When present, Show will read the list file given instead of reading images directly.
	The list file is made of lines of text, each of which is a file name.

	Example:
		Show LIST RAM:mylist

		and the content of the file RAM:mylist is:

		WORK:pics/png/john.png
		WORK:pics/tif/blue_parrot.tif
		DATAS:mypics/eros/Regina.jpg
		...

JPGQUAL=JQ/K/N:
	JPEG save quality (default=80).

JPGGRAY=JG/S:
	Load JPEG in grayscale.

JPGSIZE=JS/K/N:
	JPEG picture sizing when loading (0=auto, 1=full, 2=1/2, 4=1/4, 8=1/8; default=1).

These options take precedence over the preferences saved.
You can also invoque Show simply by
	Show
and a filerequester will appear for you to choose your files.

Invocation from Workbench:
==========================
	The tooltypes are the same than when starting from a shell except there are no
	'LIST' or 'PATTERN'.
	You can use the shortcuts.

Usage:
======
Not much to say, apart for the Compose menu:
Compose allow you to...compose several images in a big one.
To achieve that, you have to 'memorize' the images first.
So say you want to compose image1.jpg, image2.jpg, image3.jpg and image4.jpg:
	- a) load the images (!)
	- b) while each image is displayed, memorize it (menu 'Image/Memory/Memorize Image')
	- c) compose (menu 'Image/Memory/Compose Memorized Images')
Here you can choose the layout and the space between images.
Press 'OK' to save it.
Note: Pressing HELP in the main window help to remember some keyboard shortcuts
while composing or cropping.

XPK:
Files compacted/crypted with XPK are OK.
You can even crypt your images from within the program.

Preferences:
============
The preferences are saved in ENVARC:Show.prefs ('Save') and ENV:Show.prefs ('Use').
Files Comment are always preserved.

You can customize the keyboard as you like.

Versions:
=========
There are 2 versions, one for 68000 and the other for 68040 *AND* a FPU.

And...This program is TOTALLY FREE ;)


Notes:
======

a) I'm NOT a programmer, so please forgive me if you find bugs!
   Anyway, your comments are always welcome; PLEASE email me
   if you have bugs reports, comments, encouragements, etc...

b) Yes, this program still lacks many things!
   I would like to have datatypes support, but I dont have a
   clue how to gain control over the image datas in this case.
   (If YOU know how to do this, let me know...)

c) Compiled with gcc-2.7.2.1.
   It is slow and (IMHO) buggy, but it's free!

END.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    1636     861 47.3% 08-Feb-99 14:05:44  c.info
   10296    5679 44.8% 02-Feb-99 19:38:50 +RandomFiles
    9940    5503 44.6% 02-Feb-99 19:39:22 +Randomfiles.040
    4236    1806 57.3% 07-Feb-99 15:06:34 +Show.040.info
    4236    1806 57.3% 07-Feb-99 15:06:34 +Show.info
    1636     856 47.6% 08-Feb-99 14:05:58  docs.info
    1070     522 51.2% 02-Feb-99 19:37:18 +RandomFiles.readme
     852     372 56.3% 07-Feb-99 15:40:46 +RandomFiles.readme.info
     852     371 56.4% 08-Feb-99 14:04:54 +Show.install.info
    4619    2235 51.6% 07-Feb-99 15:36:58 +Show.readme
     852     370 56.5% 07-Feb-99 15:38:42 +Show.readme.info
    1636     859 47.4% 08-Feb-99 14:05:40  libs.info
  105728   62326 41.0% 11-Aug-98 11:34:10 +gtlayout.library
  172136   96982 43.6% 20-Mar-98 23:33:34 +ixemul000.library
  167244   95569 42.8% 28-Jun-98 15:59:40 +ixemul040fpu.library
   46148   30624 33.6% 09-Sep-97 04:18:24 +reqtools.library
    1636     852 47.9% 08-Feb-99 14:08:34  locale.info
    1636     851 47.9% 08-Feb-99 14:08:42 +catalogs.info
    1636     853 47.8% 08-Feb-99 14:07:22 +français.info
    7122    2955 58.5% 06-Feb-99 15:38:36 +Show.catalog
    1636     853 47.8% 08-Feb-99 14:09:08  s.info
      56      56  0.0% 02-Feb-99 19:10:50 +RandomFiles.cfg
   12197    3455 71.6% 06-Feb-99 15:36:36  show.cd
     417     229 45.0% 08-Feb-99 14:26:04 +Show.install
  559072  243469 56.4% 08-Feb-99 15:41:58 +Show
  551296  239431 56.5% 08-Feb-99 17:39:26 +Show.040
-------- ------- ----- --------- --------
 1669821  799745 52.1% 08-Feb-99 23:32:20   26 files
